home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1993 / Internet Info CD-ROM (Walnut Creek) (1993).iso / networking / terms / kermit / c / qnxker.man < prev    next >
Encoding:
Text File  |  1988-08-16  |  15.3 KB  |  421 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.      KERMIT(1)                QNX Software Manual                 KERMIT(1)
  73.  
  74.  
  75.  
  76.  
  77.      NAME   
  78.      NAME 
  79.  
  80.           kermit - file transfer, virt.  terminal over tty link 
  81.  
  82.  
  83.  
  84.      SYNOPSIS   
  85.      SYNOPSIS 
  86.  
  87.  
  88.  
  89.                kermit c [ lbe ] [ line ] [ baud ] [ esc ] 
  90.  
  91.  
  92.  
  93.                kermit r [ ddilb ] [ line ] [ baud ] 
  94.  
  95.  
  96.  
  97.                kermit s [ ddilb ] [ l
  98. ine ] [ baud ] file ...  
  99.  
  100.  
  101.  
  102.      DESCRIPTION   
  103.      DESCRIPTION 
  104.  
  105.           Kermit                                                         
  106.           Kermit provides reliable file transfer and primitive virtual 
  107.  
  108.           terminal communication   between  machines.    It  has  been
  109.  
  110.           implemented   on   many   different   computers,   including
  111.  
  112.           microprocessors (see  below).   The files transferred may be
  113.  
  114.           arbitrary ASCII  data  (7-bit  characteand  may  be  of  any
  115.          length.    The   file   transfer  protocol  uses  small  (94
  116.  
  117.           character) checksummed packets, with ACK/NACK responses  and
  118.  
  119.                        Kermit                                           
  120.           timeouts.    Kermit currently uses a five second timeout and
  121.  
  122.           ten retries.  
  123.  
  124.  
  125.  
  126.                                  kermit                                 
  127.                The arguments to  kermit are a set of flags (no  spaces
  128.  
  129.           between the flags), three optional
  130. args (which, if included, 
  131.  
  132.           must  be in the same order as the flags which indicate their
  133.  
  134.           presence), and, if this is a Send operation a list of one or 
  135.  
  136.                                                                    tar  
  137.           more files.  (It is similar in some way to  the  Unix    tar
  138.  
  139.           command structure).  
  140.  
  141.  
  142.  
  143.                Kermit                                                    
  144.                Kermit has three modes, Connect, Send, and Receive. The
  145.      first  is  for  a virtual terminal connection, the other two
  146.  
  147.           for file transfer.  These modes are specified by  the  first
  148.  
  149.                                 c  s  or r                               
  150.           flag, which should be c, s, or r, respectively.  Exactly one 
  151.  
  152.           mode must be specified.  
  153.  
  154.  
  155.  
  156.                       d                     kermit                      
  157.                The    d flag (debug) makes  kermit a bit more verbose.
  158.  
  159.                      kermit
  160.                                     
  161.           The states kermit goes through are printed along with  other
  162.  
  163.                                                      d                  
  164.           traces  of  it's  operation.    A  second  d flag will cause
  165.  
  166.           kermit                                         
  167.           kermit to give an even more detailed trace.  
  168.  
  169.  
  170.  
  171.                     i                                                    
  172.                The  i flag (image) allows slightly more efficie
  173. nt file 
  174.  
  175.           transfer between  Unix  machines.    Normally  (on   Kermits
  176.  
  177.           defined to run on Unix systems) newline is mapped to CRLF on 
  178.  
  179.           output, CR's are discarded on input, and bytes are masked to 
  180.  
  181.           7 bits.  If this is set, no mapping is done on newlines, and 
  182.  
  183.           all eight  bits  of each byte are sent or received.  This is
  184.  
  185.           the default for non-Unix kermits.  
  186.  
  187.  
  188.  
  189.                     l                                           kermit
  190.       The  l flag (line) specifies the tty line that   kermit
  191.  
  192.           should use  to  communicate with the other machine.  This is
  193.  
  194.                                                                      l  
  195.           specified as a regular device name, like "$mdm". If  no    l
  196.  
  197.                                                                 kermit  
  198.           option  is  specified,  standard  input  is used and  kermit
  199.  
  200.           assumes it is running  on  the  remote  host  (ie.  NOT  the
  201. machine to which your terminal is attached).  
  202.  
  203.  
  204.  
  205.                       b                                                 
  206.                The    b  flag  (baud)  sets  the baud rate on the line
  207.  
  208.                            l                                    b        
  209.           specified by the l flag.  No changes are made if the  b flag 
  210.  
  211.           is not used.  Legal speeds are: 110, 150, 300,  1200,  2400,
  212.  
  213.  
  214.  
  215.  
  216.                                       -1-
  217.  
  218.  
  219.  
  220.  
  221.  
  222.      KERMIT(1)                QNX Soft
  223. ware Manual                 KERMIT(1)
  224.  
  225.  
  226.  
  227.  
  228.           4800, 9600.  
  229.  
  230.  
  231.  
  232.                       e                                                 
  233.                The    e flag (escape) allows the user to set the first
  234.  
  235.           character of the two character escape sequence  for  Connect
  236.  
  237.                                                       kermit             
  238.           mode.  When the escape character is typed,  kermit will hold 
  239.  
  240.           it and  wait  for the next character.  If the next character
  241.  
  242.               c     C  kermit                                           
  243.           is  c or  C, kermit  will  close  the  connection  with  the
  244.  
  245.                                                               b     B   
  246.           remote host.    Similarly, if the next character is b or  B,
  247.  
  248.           kermit                                                        
  249.           kermit will send a BREAK signal to the remote host.  If  the
  250.  
  251.                                      ____
  252.  
  253.           second  character  is  the same as the escape character, the
  254.  
  255.           escape character itself is passed.  Any character other than 
  256.  
  257.           these three results in a  bell  being  sent  to  the  user's
  258.  
  259.           terminal and  no  characters passed to the remote host.  All
  260.  
  261.           other typed characters are passed through  unchanged.    The
  262.  
  263.           default escape character is '^'.  
  264.  
  265.  
  266.  
  267.                       p                                                 
  268.                The
  269. p  flag  (parity)  allows  parity  to  be set on
  270.  
  271.           outgoing packets and stripped on incoming  ones.    This  is
  272.  
  273.           useful  for  communicating  with IBM hosts or over networks,
  274.  
  275.           such as TELENET, that usurp the parity bit.    The  possible
  276.  
  277.           values  for  parity  are mark, space, even, odd or none (the
  278.  
  279.           default).  
  280.  
  281.  
  282.  
  283.                     t                         kermit                     
  284.                The  t flag (turnaround) tells kermit while in protoc
  285. ol 
  286.  
  287.           mode  (sending  or  receiving)  to  wait  for  a  turnaround
  288.  
  289.           character  (XON)  from  the other host after receiving every
  290.  
  291.                                              kermit                      
  292.           packet.  This is necessary to run  kermit with a half duplex 
  293.  
  294.           host such as an IBM mainframe.  
  295.  
  296.  
  297.  
  298.                     h                            kermit                 
  299.                The  h flag (half duplex) makes   kermit  echo  locally
  300.  
  301.           any char
  302. acters   typed  in  connect  mode.    This  is  also
  303.  
  304.           necessary to communicate with a half duplex system  like  an
  305.  
  306.           IBM  370.   The file arguments are only meaningful to a Send
  307.  
  308.           kermit                  kermit                                
  309.           kermit.  The Receiving  kermit will  attempt  to  store  the
  310.  
  311.           file  with  the  same  name  that  was used to send it.  QNX
  312.  
  313.           kermits                                                       
  314.           kermits n
  315. ormally convert outgoing file  names  to  uppercase
  316.  
  317.                                                         f               
  318.           and incoming  ones  to  lower  case (see the  f flag).  If a
  319.  
  320.           filename contains a slash  (/)  all  outgoing  kermits  will
  321.  
  322.           strip  off  the  leading  part  of the name through the last
  323.  
  324.           slash.  
  325.  
  326.  
  327.  
  328.      EXAMPLE   
  329.      EXAMPLE 
  330.  
  331.           For this example we will assume two QNX machines.    We  are
  332.  
  333.           logged   onto  "qnxa"  (the
  334.   local  machine),  and  want  to
  335.  
  336.           communicate with "qnxb" (the remote machine).   There  is  a
  337.  
  338.           modem on "$mdm".  
  339.  
  340.  
  341.  
  342.                We  want to connect to "qnxb", then transfer "file1" to
  343.  
  344.           that machine.  
  345.  
  346.  
  347.  
  348.           We type: kermit clb $mdm 1200 
  349.  
  350.  
  351.  
  352.           Kermit answers: Kermit: connected...  
  353.  
  354.  
  355.  
  356.           Now we dial  the  remote  machine  and  connect  the  modem.
  357.  
  358.           Anything  typed  on  the terminal will be sent to the remote
  359.  
  360.           machine a
  361. nd any output from that machine will  be  displayed
  362.  
  363.           on our  terminal.   We hit Control-Z, get a login herald and
  364.  
  365.  
  366.  
  367.  
  368.                                       -2-
  369.  
  370.  
  371.  
  372.  
  373.  
  374.      KERMIT(1)                QNX Software Manual                 KERMIT(1)
  375.  
  376.  
  377.  
  378.  
  379.           log in.  
  380.  
  381.  
  382.  
  383.                                        kermit                            
  384.                Now we need to start a  kermit on the remote machine so 
  385.  
  386.           that we can send the file over.    First  we  start  up  the
  387.                                               kermit                   
  388.           remote,  (in  this  case receiving)  kermit, then the local,
  389.  
  390.           (sending) one.  Remember that we are talking to  qnxb  right
  391.  
  392.           now.  
  393.  
  394.  
  395.  
  396.                We type: kermit r 
  397.  
  398.                                    kermit            
  399.           (there is now a Receive  kermit on qnxb) 
  400.  
  401.  
  402.  
  403.                                                              c          
  404.                We  type  ^  (the escape character) a
  405. nd then  c to kill
  406.  
  407.                                   kermit     
  408.           the local (Connecting)  kermit.  
  409.  
  410.  
  411.  
  412.                Kermit disconnected.  
  413.  
  414.  
  415.  
  416.                We type: kermit slb $mdm 1200 file1 
  417.  
  418.  
  419.  
  420.                Kermit answers: Sending file1 as FILE1 
  421.  
  422.  
  423.  
  424.                                                     kermit              
  425.                When the transmission is finished,   kermit  will  type
  426.  
  427.           either  "Send complete", or "Send failed.", depending on the
  428.  
  429.           success
  430.  of the transfer.  If we now  wanted  to  transfer  a
  431.  
  432.           file  from qnxb (remote) to qnxa (local), we would use these
  433.  
  434.           commands: 
  435.  
  436.  
  437.  
  438.  
  439.                     kermit clb $mdm 1200
  440.                     (connected to qnxb)
  441.                     kermit s file9
  442.                     ^c (up-arrow c not control-c)
  443.                     (talking to qnxa again)
  444.                     kermit rl $mdm 1200
  445.  
  446.  
  447.  
  448.  
  449.  
  450.                After all the transfers were done,  we  should  connect
  451.                                   kermit               
  452.           again, log off of qnxb, kill the Connect  kermit and hang up 
  453.  
  454.           the phone.  
  455.  
  456.  
  457.  
  458.                Detail  on other implementations and on the protocol is
  459.  
  460.                         ______ _____ _____            ______  ________  
  461.           given in the  Kermit Users Guide , and the  Kermit  Protocol
  462.  
  463.           ________   
  464.           Handbook 
  465.  
  466.  
  467.  
  468.      FEATURES   
  469.      FEATURES 
  470.  
  471.  
  472.  
  473.                The   KERMIT   Protocol   uses   onl
  474. y   printing  ASCII
  475.  
  476.           characters, Ctrl-A, and CRLF. Ctrl-S/Ctrl-Q flow control can 
  477.  
  478.           be  used  "underneath"  the  Kermit  protocol  (TANDEM  line
  479.  
  480.           discipline on Berkeley Unix).  
  481.  
  482.  
  483.  
  484.                       kermit                                            
  485.                This   kermit does have timeouts when run under QNX, so
  486.  
  487.           the  protocol  is  stable  when  communicating  with  "dumb"
  488.  
  489.           kermits (that don't have timeouts).  
  490.  
  491.  
  492.  
  493.      OTHER IMPLEMENTATIO
  494. NS   
  495.      OTHER IMPLEMENTATIONS 
  496.  
  497.           Kermits  have been written for TOPS-20, TOPS-10, IBM VM/CMS,
  498.  
  499.           Unix, VAX/VMS, RT-11, MS-DOS, CP/M, and Apple DOS.  
  500.  
  501.  
  502.  
  503.  
  504.                                       -3-
  505.  
  506.  
  507.  
  508.  
  509.  
  510.      KERMIT(1)                QNX Software Manual                 KERMIT(1)
  511.  
  512.  
  513.  
  514.  
  515.                         kermit                                          
  516.                The QNX  kermit in use at Merrell Dow has  been  tested
  517.  
  518.           with  MS-Kermit (PC-DOS), Ckermit (Xenix), U
  519. nix Kermit (Unix
  520.  
  521.           System V) Kermit-11 (RSX-11M) ,  Kermit-32  under  VMS,  and
  522.  
  523.           Kermit-20  under  TOPS-20.  More information is given in the
  524.  
  525.           ______ _____ _____     
  526.           Kermit Users Guide.  
  527.  
  528.  
  529.  
  530.      SEE ALSO   
  531.      SEE ALSO 
  532.  
  533.           stty(1) 
  534.  
  535.  
  536.  
  537.                ______ _____ _____  ______ _______  _ ___ __              
  538.                Kermit Users Guide, Fourth Edition (4 May 83), Frank da 
  539.  
  540.           Cruz, Daphne Tzoar, Bill Catchings 
  541.  
  542.  
  543.  
  544.                ____
  545. __ ________ ______  ________ _______  _   __  _____  
  546.                Kermit Protocol Manual, Protocol Version  3  (29  April
  547.  
  548.           __                                   
  549.           83), Frank da Cruz, Bill Catchings 
  550.  
  551.  
  552.  
  553.                Both  of  the  above  documents  are  from the Columbia
  554.  
  555.           University Center for Computing Activities,  New  York,  New
  556.  
  557.           York, 10027.  
  558.  
  559.  
  560.  
  561.      AUTHORS   
  562.      AUTHORS 
  563.  
  564.           KERMIT  kernel by Bill Catchings, Columbia University Center
  565.      for Computing Activities 
  566.  
  567.  
  568.  
  569.                KERMIT-Unix adaptation by Chris Maio and  Bob  Cattani,
  570.  
  571.           Columbia University Computer Science Dept.  
  572.  
  573.  
  574.  
  575.                Local  mods  for v6, System III, and System V by Walter
  576.  
  577.           Underwood. Includes bug fixes from Jim Guyton at RAND-Unix.  
  578.  
  579.  
  580.  
  581.                KERMIT-QNX adaption by Anthony J. Starks at Merrell Dow 
  582.  
  583.           Research Institute.  
  584.  
  585.  
  586.  
  587.      DIAGNOSTICS   
  588.      DIAGNOSTICS 
  589.  
  590.            cannot open device
  591.   "cannot open device" 
  592.  
  593.  
  594.  
  595.                                  line                                   
  596.           The file named in the  line argument did not  exist  or  had
  597.  
  598.           the wrong permissions.  
  599.  
  600.  
  601.  
  602.            bad line speed    
  603.           "bad line speed" 
  604.  
  605.  
  606.  
  607.                baud                                    
  608.           The  baud argument was not a legal speed.  
  609.  
  610.  
  611.  
  612.            Could not create file    
  613.           "Could not create file" 
  614.  
  615.  
  616.  
  617.                         kermit
  618.                               
  619.           A  Receive    kermit could not create the file being sent to
  620.  
  621.           it.  
  622.  
  623.  
  624.  
  625.            nothing to connect to    
  626.           "nothing to connect to" 
  627.  
  628.  
  629.  
  630.                      kermit                        line              
  631.           A Connect  kermit was started without a  line argument.  
  632.  
  633.  
  634.  
  635.      BUGS AND CAVEATS   
  636.      BUGS AND CAVEATS 
  637.  
  638.           There is no  locking  on  the  use  of  the  outgoing  line.
  639.  
  640.                                      kermit
  641.                             
  642.           Several  users  could run  kermit  (or anything else) on the
  643.  
  644.           line simultaneously.  
  645.  
  646.  
  647.  
  648.                The name "kermit" is not an acronym,  but  named  after
  649.  
  650.           the frog  of  Seasame Street fame.  ("Kermit" is also Celtic
  651.  
  652.  
  653.  
  654.  
  655.                                       -4-
  656.  
  657.  
  658.  
  659.  
  660.  
  661.      KERMIT(1)                QNX Software Manual                 KERMIT(1)
  662.  
  663.  
  664.  
  665.  
  666.           for "free") 
  667.  
  668.  
  669.  
  670.                This  implementation   does   not   send   or
  671.    process
  672.  
  673.           error-message packets.  
  674.  
  675.  
  676.  
  677.                Eight-bit quoting is not implemented.  
  678.  
  679.  
  680.  
  681.                Terminal  emulation mode drops characters after 1200(?)
  682.  
  683.           baud.  
  684.  
  685.  
  686.  
  687.                The message "GETC: file not open for read" or some such 
  688.  
  689.           may occur during transfers.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.                                       -5-
  742.  
  743.  
  744.  
  745.